Unique things

Many of the features and commands in Symata will be familiar from other programs. This notebook presents a few things that may be unfamiliar and not documented elsewhere. Also note that many of the "unique" features appear in other tutorial notebooks.



In [1]:

    
using Symata  # enter Symata mode

Version information

Version information of main components.



In [2]:

    
VersionInfo()









    



Symata version     0.4.2-dev.4
Julia version      0.7.0-beta2.1
Python version     2.7.14+
SymPy version      1.0

OutputStyle

OutputStyle selects the appearance of printed (or rendered) Symata expressions. See the notebook "InteractingWithSymata" for more details.



In [3]:

    
? OutputStyle









    





OutputStyle(InputForm)
print plain 1d text output.

OutputStyle(UnicodeForm)
print 1d text output with pretty unicode characters.

OutputStyle(JupyterForm)
in a Jupyter notebook, print in typeset mathematics style using latex.

OutputStyle()
Return the current output style.
InputForm and UnicodeForm give output that is valid Symata input for the same expression.







    



See also CompactOutput.

 Attributes(OutputStyle) = [Protected]

Timing evaluation

Use Time(True) and Time(False) to toggle timing and allocation information after evaluation of each input line. Use Timing(expr) to time the evaluation of expr only.

Suppress the output when using Timing like this



In [4]:

    
Timing(Range(10^5), Null)  # jit compile

Timing(Range(10^5), Null)









    Out[4]:





$$  \left[ 0.008664348,\text{Null} \right]  $$

Help

? prints help on the Help function.

Help(topic), Help("topic"), or ? topic prints documentation for topic.

h"words" does a case insensitive search of the contents of help documents.

Syamta uses the python package SymPy extensivley. Help prints relevant SymPy documentation along with Symata documentation. Type ShowSymPyDocs(False) to disable printing SymPy documentation.

Big integers

By default, Symata converts input integers to the Julia type Int. But, you may want bigger numbers:



In [5]:

    
2^100   # overflow









    Out[5]:





$$ 0 $$



In [6]:

    
? BigIntInput









    





BigIntInput(True)
enable interpreting all integers as arbitrary precision BigInts.

BigIntInput(False)
(default) disable interpreting all integers as arbitrary precision BigInts.

BigIntInput()
Return the current state.
You can always specify that an integer should be a BigInt by giving BI(n).







    



See also BF, BI, Big, BigFloatInput, GetPrecison, N, and SetPrecision.

 Attributes(BigIntInput) = [Protected]



In [7]:

    
BigIntInput(True);



In [8]:

    
2^100









    Out[8]:





$$ 1267650600228229401496703205376 $$

Note that this only applies to input integers (at the moment)



In [9]:

    
Head(Cos(Pi))









    Out[9]:





$$ \text{Int64} $$



In [10]:

    
Head(BI(Cos(Pi)))     # Convert explicitly to BigInt









    Out[10]:





$$ \text{BigInt} $$

Another way to parse a single number as a BigInt



In [11]:

    
BigIntInput(False)
big"2"^100









    Out[11]:





$$ 1267650600228229401496703205376 $$

Passing data between Julia and Symata

Symata's host language is Julia. There are several ways to interact with Julia in a Symata session.

Julia and Symata keep separate lists of symbols. For instance, x may be defined in Julia, but not Symata, and vice versa.

Use SetJ to bind (i.e. set) a Julia symbol to a Symata expression.



In [12]:

    
? SetJ









    





SetJ(x,val)
sets the Julia symbol x to val.
Variables and functions in Symata are separate from those in Julia, ie, their table of bindings to symbols are separate.







    




 Attributes(SetJ) = [HoldFirst,Protected]



In [13]:

    
expr = x + y









    Out[13]:





$$ x + y $$

Bind the Julia variable z to the result of evaluating expr.



In [14]:

    
SetJ(z , expr)









    Out[14]:





$$ x + y $$

Execute Julia code, by enclosing it in J( ). We ask for the value of z.



In [15]:

    
J(Main.z)









    Out[15]:





$$ x + y $$

We can also leave Symata and return to Julia



In [16]:

    
Julia()  # begin interpreting expressions as Julia code. ;



In [17]:

    
z         # Now in Julia









    Out[17]:





:x + :y

The unexported Julia function symval returns the Symata binding of a symbol.



In [18]:

    
? Symata.symval



In [19]:

    
Symata.symval(:expr)









    Out[19]:





:x + :y

We can do the reverse, set a Symata variable to the value of a Julia variable.

Set a variable in Jula.



In [20]:

    
a = 1      # Set a Julia symbol  (bind an identifier to a value)









    Out[20]:




1



In [21]:

    
isymata()   # Enter Symata mode again



In [22]:

    
expr2 = J( Main.a  )
expr2









    Out[22]:





$$ 1 $$

Symata symbol expr2 is now set to 1.

SymPy

Symata uses the python package SymPy extensively. Most of the interaction with SymPy is transparent to the user. But there are several commands for controlling this interaction.

Use Symata's help search feature to find commands related to SymPy.



In [23]:

    
h"sympy"









    



ExpandA
Part
Args
SymPyError
Rewrite
MmaSyntax
ReturnSymPy
ShowSymPyDocs
ToSymPy
PyHead
ToSymata
CoefficientSympy



In [24]:

    
? SymPyError









    





SymPyError()
Return the most recent SymPy error message. If you see a message warning that a SymPy error has occurred, you can find the detailed error message.







    




 Attributes(SymPyError) = [Protected]

For debugging, you can disable converting SymPy objects to Symata.



In [25]:

    
? ReturnSymPy









    





ReturnSymPy(True)
disable conversion of expressions computed by SymPy to Symata.

ReturnSympy(False)
(default) enable conversion to Symata.

ReturnSympy()
Return the current state.







    



See also ShowSymPyDocs, ToSymPy, and ToSymata.

 Attributes(ReturnSymPy) = [Protected]



In [26]:

    
? ToSymata









    





ToSymata(expr)
convert the python PyObject expr to a Symata expression. Normally, expressions computed by SymPy are automatically converted to Symata expressions.







    



See also ReturnSymPy, ShowSymPyDocs, and ToSymPy.

 Attributes(ToSymata) = [HoldAll,Protected]



In [27]:

    
? ToSymPy









    





ToSymPy(expr)
convert expr to a (python) PyObject.







    



See also ReturnSymPy, ShowSymPyDocs, and ToSymata.

 Attributes(ToSymPy) = [Protected]

Use ToSymPy and ToSymata to convert between the languages.



In [28]:

    
OutputStyle(InputForm)
pyobj = ToSymPy(Integrate(f(x),x))









    Out[28]:





PyObject Integral(f(x), x)



In [29]:

    
OutputStyle(JupyterForm)
[Head(pyobj), PyHead(pyobj)]









    Out[29]:





$$  \left[ \text{PyCall.PyObject},\text{Integral} \right]  $$

Recover the Symata expression.



In [30]:

    
ToSymata(pyobj)









    Out[30]:





$$ \int f \!  \left( x \right)  \,  \mathbb{d}x $$

Version and date



In [31]:

    
VersionInfo()









    



Symata version     0.4.2-dev.4
Julia version      0.7.0-beta2.1
Python version     2.7.14+
SymPy version      1.0



In [32]:

    
InputForm(Now())









    Out[32]:





2018-07-21T19:36:54.357